home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / devnag.zip / READ.ME < prev   
Text File  |  1991-05-26  |  7KB  |  129 lines
  1.                       *********************************
  2.                       *                               *
  3.                       *      DEVANAGARI FOR TeX       *
  4.                       *          VERSION 1.2          * 
  5.                       *   INSTALLATION INSTRUCTIONS   *
  6.                       *                               *
  7.                       *********************************
  8.                       *                               *
  9.                       *      Frans J. Velthuis        *
  10.                       *      Computing Center         *
  11.                       *      University of Groningen  *
  12.                       *      The Netherlands          *
  13.                       *                               *
  14.                       *********************************
  15.  
  16. This package contains software for the printing of the devanagari script
  17. with TeX. The devanagari script is used for a number of languages from 
  18. Northern and Central India, such as Hindi and Marathi. It is also the script
  19. used for writing and printing Sanskrit.
  20.  
  21. The package contains the following files:
  22. * DNMACS.TEX: macro file for TeX.
  23. * DEV.STY: macro file for LaTeX.
  24. * DVNG8.TFM, DVNG9.TFM, DVNG10.TFM: TFM files.
  25. * DEVNAG.EXE, DEVNAG.C: preprocessor (MS-DOS executable plus C-source).
  26. * MISSPAAL.DN: an example file.
  27. * MANUAL.TEX: the User Manual.
  28. * READ.ME: this file.
  29. * PK files for 300dpi black-writing laserprinters.
  30. * DEFS.MF, DNCHARS.MF, DVNG10.MF, DVNG9.MF, DVNG8.MF: Metafont source files.
  31.  
  32. In order to install the software you have to put the files in the right
  33. directories and rename them (if necessary).
  34.  
  35. * DNMACS.TEX, DEV.STY, MISSPAAL.DN and MANUAL.TEX must be in the directory 
  36.   where TeX expects it's input. This is something like C:\TEX\INPUTS on
  37.   MS-DOS systems. 
  38.  
  39. * DEVNAG.EXE is the preprocessor executable for MS-DOS systems. It must be
  40.   in a directory specified in the PATH environment-variable. Preferably it
  41.   should be put in the directory where other executable files are kept, often
  42.   called BIN.  
  43.   If you are using the software on a system other than MS-DOS, then the source,
  44.   DEVNAG.C, must be compiled with a C-compiler, after which the executable
  45.   must be put in a directory where the system can find it.
  46.   The source-code regrettably contains very little commentary (mostly due to
  47.   laziness on my part, I'm afraid), but with a little persistence it should 
  48.   be possible to modify the code if you don't like the behaviour of the
  49.   preprocessor. Someone might also see it as a challenge to use the new
  50.   features of TeX 3.x, Virtual Fonts and the new Metafont  in such a way
  51.   that a preprocessor is not necessary any more. Would anyone who accomplishes
  52.   this please contact me?
  53.  
  54. * If you do have a 300dpi black-writing laser-printer then you can use the 
  55.   included PK and TFM files. The TFM-files have to be put in the directory
  56.   where TeX keeps its TFM-files, mostly called C:\TEX\FONTS or something like
  57.   that. The organization of the fontfiles (PK-files) varies from installation
  58.   to installation. Sometimes all the fontfiles are put together in one large
  59.   directory and the different magnifications of a font are distinguished by 
  60.   their filename extension, as is the case with the fonts in this package.
  61.   Instead of in a directory the font files are sometimes put in a library.
  62.   This is the way it is done in emTeX. And sometimes there are different
  63.   directories for each magnification. These directories have 'names' like
  64.   300, 329 etc. The fontfiles within these directories have no extensions or
  65.   just the extension 'PK'. 
  66.   According to which fontfile-organization is used on your system, you have
  67.   to copy and rename the fontfiles in the PK300 directory in this package.
  68.  
  69. * If your printer is not a 300dpi black-writing laser-printer, or if you want
  70.   to change the appearance of the font or of some characters in it, or if you
  71.   want to add characters (there are ligatures in use which are not represented
  72.   in this font) then you have to run Metafont and use the .MF files as input.
  73.   (The following is taken from: FAQ about TeX)
  74.     
  75.     METAFONT allows you to create your own fonts. METAFONT, unlike TeX,
  76.     requires some customization. Each output device for which you will be
  77.     generating fonts needs a mode associated with it. Modes are defined
  78.     using the mode_def convention described on page 94 of _The METAFONTbook_.
  79.     The person who installed METAFONT on your system should know which
  80.     modes are defined.
  81.  
  82.     The usual way to create a font with plain METAFONT is to start 
  83.     it with the line
  84.        \mode=<mode name>; mag=<magnification>; input <font file name>
  85.     in response to the * prompt or on the METAFONT command line. If 
  86.     <mode name> is unknown or omitted, then the mode defaults to proof 
  87.     mode. If this has happened METAFONT will produce an output file
  88.     called <font file name>.2602gf. The <magnification> is a floating 
  89.     point number or magstep (magsteps are defined in _The METAFONTbook_ 
  90.     and _The TeXbook_). If mag=<magnification> is omitted, then the 
  91.     default is 1. For example, to generate dvng10 at 12pt for an epson 
  92.     printer you would type
  93.        mf \mode=epson; mag=1.2; input dvng10
  94.  
  95.     If you need a special mode that isn't defined for your Metafont,
  96.     you can put its commands in a file (e.g., ln03.mf) and invoke
  97.     it on the fly with the \smode command. For example, to create 
  98.     dvng10.300gf for an LN03 printer, using the file
  99.     % This is ln03.mf as of 2/27/90
  100.     % mode_def courtesy of John Sauter
  101.     proofing:=0;
  102.     fontmaking:=1;
  103.     tracingtitles:=0;
  104.     pixels_per_inch:=300;
  105.     blacker:=0.65;
  106.     fillin:=-0.1;
  107.     o_correction:=.5;
  108.     (note the absence of the mode_def and enddef commands), we would type
  109.        mf \smode="ln03"; input dvng10
  110.  
  111.   There are Metafont source files for 3 different sizes: 8,9 and 10 point:
  112.   DVNG8.MF, DVNG9.MF and DVNG10.MF. All of these three source-files make use
  113.   of DEFS.MF and DNCHARS.MF. Just as is the case with DEVNAG.C, there is not
  114.   much commentary in these Metafont source-files.
  115.   A nice feature of Metafont, the possibility to use macro's, is not used very
  116.   much because this is very memory-consuming and caused a premature halt of
  117.   Metafont on small systems like PC's. 
  118.  
  119. * The package contains a test file called MISSPAAL.DN. (The first page of
  120.   a Hindi short story by Mohan Raakesh). So you can verify that everything was
  121.   installed successfully by first running the preprocessor: 'devnag misspaal';
  122.   after that running TeX: 'tex misspaal';
  123.   and then printing the resulting DVI-file <misspaal.dvi> on your printer.
  124.   (It is often convenient to create a command procedure which contains
  125.   these three commands.) Also included is a User Manual: MANUAL.TEX.
  126.   If the installation was successful, you can print this manual and start
  127.   creating devanagari text.
  128.  
  129.